{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Tutorial 9a - Edmund Optics Catalogue"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "tags": [
     "nbsphinx-toctree"
    ]
   },
   "source": [
    "### August 2024"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This tutorial shows how to retrieve optical components from the [Edmund Optics](https://www.edmundoptics.com/) lens catalogue. In particular, we cover:\n",
    "\n",
    "- How to open Zemax files in Optiland\n",
    "- How to retrieve and analyze an aspheric lens from the Edmund Optics catalogue"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Optiland uses the function `load_zemax_file` to load a Zemax (.zmx) files into the Optiland format. The function accepts either a file directly or a URL link to the file. If a URL is provided, Optiland downloads the file prior to extracting the lens data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "from optiland import analysis\n",
    "from optiland.fileio import load_zemax_file"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "File retrieval\n",
    "\n",
    "\n",
    "For this example, we will use a [15 mm Dia., 0.33 Numerical Aperture Uncoated, Aspheric Lens](https://www.edmundoptics.com/p/15mm-dia-033-numerical-aperture-uncoated-aspheric-lens/7881/). We pass the filename of the downloaded .zmx file to our `load_zemax_file` function:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "filename = \"zmax_47728.zmx\"  # downloaded from link above\n",
    "lens = load_zemax_file(filename)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The function directly returns an instance of an Optiland Optic class. We can draw the lens as shown."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "lens.draw()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "We also print an overview of the lens data. This currently excludes the aspheric coefficients."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "+----+---------------------+----------+-------------+------------+----------+-----------------+\n",
      "|    | Type                |   Radius |   Thickness | Material   |    Conic |   Semi-aperture |\n",
      "|----+---------------------+----------+-------------+------------+----------+-----------------|\n",
      "|  0 | Planar              |  inf     |    inf      | Air        |  0       |     7.5         |\n",
      "|  1 | Stop - Even Asphere |   13.255 |      4      | L-BAL35    | -2.36414 |     7.5         |\n",
      "|  2 | Planar              |  inf     |     19.9823 | Air        |  0       |     6.66094     |\n",
      "|  3 | Planar              |  inf     |    nan      | Air        |  0       |     2.66454e-15 |\n",
      "+----+---------------------+----------+-------------+------------+----------+-----------------+\n"
     ]
    }
   ],
   "source": [
    "lens.info()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Lens Analysis\n",
    "\n",
    "\n",
    "To assess performance, we generate a spot diagram and the ray aberration fans:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1200x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "spot = analysis.SpotDiagram(lens)\n",
    "spot.view()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x333 with 2 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "fan = analysis.RayFan(lens)\n",
    "fan.view()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Conclusions\n",
    "\n",
    "- This tutorial showed how to retrieve and analyze an Edmund Optics catalogue lens.\n",
    "- The load_zemax_file function does not currently support all Zemax surface types and may fail to convert a lens into an Optiland Optic instance in some cases. Users are encouraged to create an issue on the GitHub page if an error occurs."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": ".venv",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.11.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}
